web3.js@0.2x.x web3.eth.getBalance

web3.eth.getBalance(addressHexString [, defaultBlock] [, callback])

任意のブロックにおけるアドレスの残高を返します。

パラメータ

1. String

残高を取得するアドレス

2. Number|String

オプショナル

ブロック番号

ブロック番号を指定しない場合は、web3.js@0.2x.x web3.eth.defaultBlock の値が使用されます。

3. Function

オプショナル

コールバック関数を渡した場合は、HTTP リクエストが非同期に実行されます。

戻り値

BigNumber

アドレスの残高

単位は wei

オリジナルのリファレンスでは String となっているが、おそらく BigNumber のインスタンス

#todo 要検証

サンプルコード

code:example.js

var balance = web3.eth.getBalance("0xF02c1c8e6114b1Dbe8937a39260b5b0a374432bB");

console.log(balance); // instanceof BigNumber

console.log(balance.toString(10)); // '1000000000000'

console.log(balance.toNumber()); // 1000000000000

参考